home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TA / (A)TAD.ADF / FileTransfers < prev    next >
Text File  |  1986-11-06  |  26KB  |  620 lines
  1. *********************************************************************
  2. This article is being presented through the *StarBoard* Journal of
  3. the FlagShip/StarShip, SIGS (Special Interest Groups) on the
  4. Delphi and GEnie telecommunications networks.  Permission is
  5. hereby granted to non-profit organizations only to reprint this
  6. article or pass it along electronically as long as proper credit
  7. is given to both the author and the *StarBoard* Journal.
  8. *********************************************************************
  9.  
  10.                   AMIGA TECH TIP: BBS FILE TRANSFERS
  11.  
  12.                            by Thad Floryan
  13.  
  14.                           (THADF on DELPHI)
  15.  
  16. Most of you start to explore the world beyond your Amiga after
  17. purchasing a modem and a communication program.  Many of you become
  18. participants in the forums and discussion groups on the BBS systems you
  19. reach while finding new "pen pals".  Some of you attempt to build your
  20. software libraries from the vast collection of free, public-domain
  21. programs found on the BBS systems, all too often with disappointing
  22. results.
  23.  
  24. The solution to your BBS woes is understanding how files and programs
  25. are stored and transferred, and knowing how and when to use a special
  26. "toolkit" of programs to fix problems.
  27.  
  28. ----------------------------------------------------------------------
  29.  
  30. THE BASICS:  TEXT FILE FORMATS
  31.  
  32. Simple text files created with an Amiga editor are stored one character
  33. after another.  Each line on an Amiga text file is ended by a line-feed
  34. whose ASCII code is 10 decimal (hex 0A).  Other systems end their lines
  35. differently; for example, a Macintosh (tm) file has its lines ended by
  36. a carriage-return whose ASCII code is 13 decimal (hex 0D), whereas an
  37. IBM PC and many mainframes end their lines with both a carriage-return
  38. and a line-feed.
  39.  
  40. The Amiga's file size will be the number of characters entered; there
  41. is no end of file character.  On many other systems the presence of the
  42. character control-Z, whose ASCII code is 26 decimal (hex 1A), indicates
  43. the end of file.
  44.  
  45. Amiga Notepad text files have their lines also ended by a line-feed,
  46. but there are more characters and binary information after the last
  47. line.  The first extra character is a control-Z, and the remainder
  48. describe the pen and paper colors and the font and its style.
  49.  
  50. The various word processors for the Amiga each have their own file
  51. formats, in which are stored tab settings, margin information, text
  52. rendition, and other specific data.  Many of the word processors have a
  53. command to store text as a "simple" file.
  54.  
  55. Source code statements for many of the programming languages available
  56. on the Amiga are also stored as "simple" ASCII files.  For example,
  57. filenames ending with ".c" are usually C programs.  The ".c" is the
  58. file's extension, and many other common source file extensions you may
  59. see on the Amiga include:
  60.  
  61.             extension   Language
  62.  
  63.               .ASM      Assembler
  64.               .C        C
  65.               .FOR      Fortran
  66.               .MOD      Modula-2
  67.               .PAS      Pascal
  68.               .SCR      Forth screen file
  69.  
  70.  
  71. ----------------------------------------------------------------------
  72.  
  73. THE BASICS:  PROGRAM FILE FORMATS
  74.  
  75. Contrasted with text files, program files are binary and are not easily
  76. digested by editors or word processors.  A program file is the
  77. translation of your source program into a machine executable form.  As
  78. such, a program file is rigidly formatted into sections called "hunks"
  79. which contain code, data, and other information that control the
  80. loading of your program from disk into memory for execution.
  81.  
  82. AmigaDOS insists on an exact file format for a program file, else it
  83. will display the dreaded "Unable to load program: file is not an object
  84. module". The most-often cause of this problem is extra data in the file
  85. beyond the "hunkend" section; several cures for this ailment are
  86. described later.
  87.  
  88. For the technically-minded, the detailed description of the program
  89. file format is in the AmigaDOS Technical Reference Manual (CBM
  90. 327266-01) and reprinted in The AmigaDOS Manual (Bantam, ISBN
  91. 0-553-34294-0) which should be consulted for specifics.
  92.  
  93. Program files typically have no extensions, but occasionally one may be
  94. found with the extension ".exe" which is short for "executable".  An
  95. extension on a program file is a carryover from other systems and is
  96. not encouraged on the Amiga, especially for programs designed to be
  97. started from the Workbench.
  98.  
  99. ----------------------------------------------------------------------
  100.  
  101. THE BASICS:  DATA AND BINARY FILE FORMATS
  102.  
  103. Data and binary files are, for the most part, formatted according to
  104. the whims of the creator.  There is one notable exception: an
  105. Interchange File Format (IFF) data file for the exchange of pictures,
  106. text and sounds between paint programs, data base systems, information
  107. retrieval systems, and other creative and productivity application
  108. programs.  Another exception is the ICON file which may be associated
  109. with a program file or a data file.
  110.  
  111. The format of an IFF file is described in the documents available on
  112. the Amiga Freely Redistributable Softare Library Disk Number 16.  The
  113. disks in this series are colloquially known as "Fish Disks" as tribute
  114. to Fred Fish who has contributed his expertise and time helping make
  115. the Amiga the success it deserves to be.  "Fish Disks" are available
  116. from FAUG, many cooperating Amiga Dealers, and by direct subscription.
  117.  
  118. A program file named MYPROG will usually have an accompanying ICON file
  119. named MYPROG.info.  A paint program saving a picture as MYMASTERPIECE
  120. will create a MYMASTERPIECE.info ICON file .  A word processor will
  121. create LETTER.info as a companion to a LETTER text data file.
  122.  
  123. Another binary file type is the object file, which is an intermediate
  124. stage between a source program file and an executable program.  Some
  125. software developers allow you to use the fruits of their labors with an
  126. object file while choosing not to reveal how they did it in a source
  127. program file.  Object files have "hunk" sections and are meant to be
  128. linked with your other object files to become an executable program.
  129. The file extensions of object files are typically ".o", ".obj", ".sub"
  130. and ".lib".
  131.  
  132. Data, object and binary files must be exchanged exactly like program
  133. files.  Extra or spurious information in such a file will confuse the
  134. recipient or application program.  Methods to assure exact transfers
  135. are discussed later.
  136.  
  137. ----------------------------------------------------------------------
  138.  
  139. THE BASICS:  PROTOCOLS
  140.  
  141. Most BBS systems you reach will either be those operating a version of
  142. BBS-PC software on an Amiga, or those operating a FIDO node on an IBM
  143. PC or variant. All of these systems will offer a Files section for
  144. their validated members.  The Files section on these systems will
  145. contain program and data files that you can use on your Amiga.
  146.  
  147. Copying a file from a BBS system to your Amiga can be almost as easy as
  148. using the COPY command to duplicate files from one place to another on
  149. your system.  However, your system and the BBS must speak the same
  150. "language" to transfer files, much as you need to converse in a common
  151. language to exchange thoughts with someone from another country.
  152.  
  153. In the parlance of the BBS community, the common language is a
  154. "protocol".  A protocol is an agreed-upon ritual of greetings,
  155. exchange, and farewells.  The most common protocols you'll see have the
  156. names TEXT, XMODEM, XMODEM-CRC, and HVP/Smartcom.
  157.  
  158. Without getting involved in a history lesson, suffice it to say that
  159. your communication program will understand one or more of these
  160. protocols.  You must tell the BBS system which protocol you are using
  161. before you can exchange files successfully.
  162.  
  163. The TEXT protocol is one in which the contents of the file are
  164. considered to be ASCII characters, and the text of the file is captured
  165. by your terminal program and stored verbatim into a file while you are
  166. reading it.  But life is not always so simple.  Some files may have
  167. been created on another type of computer system and may have different
  168. characters at the end of each line causing the text to overprint or
  169. display other strange characteristics.  Don't despair, a solution to
  170. fix the files on your system is described later.
  171.  
  172. The XMODEM protocol attempts to transfer the contents of any file to
  173. your system in chunks of 128 characters at a time.  Each chunk is
  174. preceded and followed by control information which helps to assure
  175. exact transfer of the data.  If the transfer of a chunk of data is
  176. inaccurate, the sender is instructed by the receiver to send it again.
  177. This "send and acknowledge" procedure is called handshaking.  Files
  178. transferred using the XMODEM protocol will arrive at the destination
  179. exactly as sent, except the size of the resultant file will be a
  180. multiple of 128 characters or bytes.  This "padding" of the received
  181. file is the source of problems transferring Amiga program files;
  182. remember, AmigaDOS expects a program file to adhere to an exact and
  183. specific format.  Solutions to this dilemma are discussed later.
  184.  
  185. A variation of the XMODEM protocol is one in which text files are
  186. processed differently from binary files.  This variation will convert,
  187. say, a file stored with carriage-returns and line-feeds, or with
  188. carriage-returns only, to the line-feed only format expected on the
  189. Amiga.  Consult the manual for your terminal program to see if this
  190. variation is supported by the program.  If not, you may have to
  191. post-process the file after it is downloaded to your Amiga; more
  192. details later.
  193.  
  194. The XMODEM-CRC protocol is similar to the XMODEM protocol, except that
  195. some additional information is appended to each chunk transferred that
  196. permits the receiver to correct any transmission errors.  This
  197. additional "smarts" can save time when transferring files over a noisy
  198. telephone line, because the errors can be corrected locally (on your
  199. system) without requiring the sender to re-transmit the entire chunk
  200. that was in error.  The same problems with 128-byte multiple file sizes
  201. apply here as with the standard XMODEM.
  202.  
  203. The HVP/Smartcom protocol eliminates most of the problems occurring
  204. with XMODEM transfers in that the resultant file will be the exact size
  205. as the source file, and the transmitted chunks are 512 bytes between
  206. handshakes resulting in a faster file transfer.  However, if the
  207. original file was uploaded to the BBS with XMODEM, you may still see
  208. the "file is not an object module" when you attempt to run a program
  209. downloaded with HVP/Smartcom.  The same solutions for XMODEM
  210. transferred files can be applied to HVP/Smartcom transferred files if
  211. necessary.
  212.  
  213. ----------------------------------------------------------------------
  214.  
  215. THE CURES:  PREPARATION
  216.  
  217. Many BBS systems provide a file directory listing showing a file's size
  218. and comments posted by the person who originally uploaded the file.
  219. Write down as much information about the file that you can find.  One
  220. specific item to seek is any comment referring to a "chop" size; you
  221. may need to examine all E-MAIL postings to find this information.
  222. Knowing whether a file is text, a program, or data will also be
  223. helpful.
  224.  
  225. ----------------------------------------------------------------------
  226.  
  227. THE CURES:  SOFTWARE TOOLS
  228.  
  229. You will need, as a minimum, copies of the "toolkit" programs listed
  230. below.  I suggest you get copies of the following programs direct from
  231. your dealer, users' group, or a friend; some are available on the "Fish
  232. Disks".
  233.  
  234.         USQ     Unsqueeze utilty.  Its companion is SQ which is used
  235.                 if you're uploading files to a BBS.
  236.  
  237.         RemCr   Removes carriage-returns from a text file. (Leaving,
  238.                 hopefully, line-feeds as a line terminator).
  239.  
  240.         AddCr   Adds carriage-returns before every line-feed.  Used
  241.                 before uploading a file to a BBS.
  242.  
  243.         13to10  Converts all carriage-returns to line-feeds.
  244.  
  245.         Strip   Removes control-characters and other binary "junk"
  246.                 from a text file.
  247.  
  248.         FixObj  Adjusts a program file's size so "hunkend" is at the
  249.                 proper end of file.  There is a new version: FixObj2.
  250.  
  251.         CHOP    Fixes a file to a previously-known correct size.
  252.  
  253.         ARC     Amiga archive utility.  Groups collections of files,
  254.                 and splits them into correct-sized files.
  255.  
  256.  
  257. Additionally, the TYPE program (available at the CLI command level on
  258. your Amiga) can be a valuable aid to diagnosing problems with
  259. transferred files.
  260.  
  261. ----------------------------------------------------------------------
  262.  
  263. PROGRAM TOOLS:  TYPE
  264.  
  265. The TYPE program/command is a starting point to help you determine
  266. which other tools you'll need to correct problems with downloaded
  267. files.  With TYPE you can identify executable programs, IFF pictures,
  268. compressed files, text files, and other pertinent characteristics.
  269.  
  270. For example, suppose you've downloaded a file named XYZ and you want to
  271. find out what it is.  The following samples show how to interpret the
  272. hex dump from TYPE.  Note that the "***BREAK" is a result of typing a
  273. control-C to interrupt TYPE; after a few lines of output, there is
  274. usually no need to see more.
  275.  
  276. a)CLI> type XYZ opt h
  277.         0000: 000003F3 00000000 00000046 00000000    ...........F....
  278.         ***BREAK
  279.  
  280. In this example, XYZ looks like an executable program.  The "key" is
  281. the "000003F3" which is the code for a "hunkheader".  In the absence
  282. of a file extension, it would be reasonable to assume this file is a
  283. program that could be "fixed" using FixObj or CHOP.
  284.  
  285. b)CLI> type XYZ opt h
  286. 0000: 000003E7 00000002 73747269 70000000    ........strip...
  287. ***BREAK
  288.  
  289. In this example, XYZ looks like an object file (the output of a
  290. language compiler); the clues are "000003E7" (code for a "hunkunit")
  291. and the name "strip".  In fact, this file is the object output of the
  292. Lattice C compiler for the STRIP program.  Size problems with this file
  293. could be fixed using FixObj or CHOP.
  294.  
  295. c)CLI> type XYZ opt h
  296. 0000: 76FF3BF1 5665726D 6565722D 4769726C    v.;.Vermeer-Girl
  297. 0010: 00000102 00010004 00030006 00050008    ................
  298. 0020: 00070009 0000FF0B 000A000C 006FFFFF    .............o..
  299. 0030: FF0D000F 000E0011 00100013 00120015    ................
  300. 0040: 00140017 00160019 0018001B 001A001D    ................
  301. 0050: 001C001F 001E0021 00200023 002200FC    .......!. .#."..
  302. ***BREAK
  303.  
  304. This one is "tricky"; additional clues are necessary.  From the BBS
  305. listing, this file was described as an IFF picture, yet it cannot be
  306. viewed with DeluxePaint (tm), Aegis Images (tm), GraphiCraft (tm),
  307. SeeILBM, ShowILBM or DPSlide, especially since the hex dump does NOT
  308. look like a typical IFF file dump per:
  309.  
  310. CLI> type Vermeer-Girl opt h
  311. 0000: 464F524D 00009CDC 494C424D 424D4844    FORM....ILBMBMHD
  312. 0010: 00000014 014000C8 00000000 05000000    .....@..........
  313. 0020: 00000A0B 014000C8 434D4150 00000060    .....@..CMAP...`
  314. 0030: F0F0F020 1030C050 50D05030 E06040F0    ... .0.PP.P0.`@.
  315. 0040: 8050F090 60F0A070 F09000F0 A000F0B0    .P..`..p........
  316. 0050: 00F0C040 F0C080F0 B070E0A0 60E09050    ...@.....p..`..P
  317. ***BREAK
  318.  
  319. Based on experience with other files, and because there is an item
  320. ("Vermeer-Girl") which could be a file name, this XYZ file then becomes
  321. a candidate for unsqueezing using the USQ program.
  322.  
  323. As you use TYPE to examine other files, you'll gain experience
  324. identifying files by their contents.  Another example using TYPE shows
  325. extraneous characters in a text file:
  326.  
  327. CLI> type XYZ
  328. First line
  329. Second line
  330. Last line
  331. CLI> type XYZ opt h
  332. 0000: 46697273 74206C69 6E650D0A 5365636F    First line..Seco
  333. 0010: 6E64206C 696E650D 0A4C6173 74206C69    nd line..Last li
  334. 0020: 6E650D0A                               ne..
  335.  
  336. Note the "0D0A" combinations which are carriage-returns followed by
  337. line-feeds.  The carriage-returns can be removed using either the RemCr
  338. or STRIP programs.  A final example shows another troublesome
  339. situation:
  340.  
  341. CLI> type XYZ
  342. Last linene
  343. CLI> type XYZ opt h
  344. 0000: 46697273 74206C69 6E650D53 65636F6E    First line.Secon
  345. 0010: 64206C69 6E650D4C 61737420 6C696E65    d line.Last line
  346. 0020: 0D                                     .
  347.  
  348. with lines ended by only a carriage-return (hex 0D).  When typed to the
  349. screen, each line overprints the previous one resulting in "Last
  350. linene".  This problem is fixed by using the 13to10 program, which
  351. converts all carriage-returns, whose ASCII code is 13 decimal, to
  352. line-feeds, whose ASCII code is 10 decimal.
  353.  
  354. ----------------------------------------------------------------------
  355.  
  356. PROGRAM TOOLS:  USQ and SQ
  357.  
  358. The SQueeze and UNsQueeze utilities are gaining popularity on BBS
  359. systems for the storage and transfer of single files (see ARC for
  360. collections of files).  The reason is obvious after examining the
  361. directory listing below:
  362.  
  363. CLI> list
  364. Vermeer-Girl               40164 rwed Yesterday 23:22:52
  365. Vermeer-Girl.qq            17293 rwed Yesterday 23:22:49
  366.  
  367. The file without the ".qq" extension is a normal IFF ILBM picture file
  368. created with a paint program.  The file with the ".qq" is the same file
  369. after compression using SQ.  Besides reducing disk space, a squeezed
  370. file will also download faster, saving you money and time.
  371.  
  372. Additionally, a program, text or data file is ready for immediate use
  373. after unsqueezing!  The squeezed file can be transferred using XMODEM
  374. without any worry over the effects of XMODEM padding since the
  375. unsqueezing process will create an exact image of the original file.
  376.  
  377. The SQ and USQ programs are distributed in both source and executable
  378. form on Fish Disk Number 10.  Their use is very straightforward:
  379.  
  380. CLI> SQ file1 [ file2 ... filen ]
  381.  
  382. squeezes file1 [ thru filen ] creating file1.qq [ thru filen.qq ].
  383. Very often you'll see file extensions containing the letter "Q" which
  384. is a clue that SQ was used to create the file and that USQ should be
  385. used to unsqueeze the file.  By convention, the following extensions
  386. are in common use:
  387.  
  388. .QQ   (none)for a squeezed IFF picture file
  389. .TQT  (.TXT)for a squeezed text file
  390. .DQC  (.DOC)for a squeezed documentation file
  391. .EQE  (.EXE)for a squeezed executable program file
  392.  
  393. Note also that the original file name is stored in the squeezed file as
  394. shown in example (c) of the TYPE program.
  395.  
  396.  
  397. CLI> USQ file.qq [ file2.qq ... filen.qq ]
  398.  
  399. will sequentially expand file.qq [ thru filen.qq ] to their original
  400. sizes and names.
  401.  
  402.  
  403. ****** IMPORTANT NOTE ******
  404.  
  405. You should ALWAYS first display using the "TYPE file OPT H" command the
  406. first part of any file before using USQ.  The reason is that often the
  407. original creater of a squeezed file was careless and may have squeezed
  408. a file using a directory path specification as part of the file name;
  409. USQ will attempt a restore to the same path specification on your
  410. system.  Referring to example (c) of the TYPE program, the complete
  411. original file name is stored in the squeezed file; if the creator
  412. squeezed from, say, DF2:FILE, the contents of the squeezed file would
  413. be:
  414.  
  415. CLI> type FILE.QQ opt h
  416. 0000: 76FF810B 58595A3A 46494C45 00110002    v...DF2:FILE....
  417. 0010: 00010004 00030006 00050008 0007000A    ................
  418. 0020: 00090096 FF0B0091 FF9AFF93 FFDFFF0D    ................
  419. 0030: 00F2FF0F 000E000C 0010008B FF8CFF9E    ................
  420. 0040: FF90FFAC FF8DFF9B FFB3FFB9 FF9CFFF5    ................
  421. ***BREAK
  422.  
  423. and if your system doesn't have a DF2: the USQ will fail.  Also, it is
  424. possible for USQ to overwrite another file on your system whose name is
  425. the same as that stored in the squeezed file.  An ounce of prevention
  426. is worth a pound of cure; always CHECK before blindly using the USQ
  427. program.
  428.  
  429. ----------------------------------------------------------------------
  430.  
  431. PROGRAM TOOLS:  RemCr, AddCr, 13to10, STRIP
  432.  
  433. This collection of four programs, and other similar programs, processes
  434. text files by converting, adding or deleting characters.  The source
  435. code of these programs is readily available on many BBS systems and in
  436. public domain libraries; feel free to change the programs to suit your
  437. needs.  Most utility programs of this nature are written in C, but you
  438. can write similar programs in any language available to you such as
  439. AmigaBasiC.
  440.  
  441.  
  442. RemCr simply removes all carriage-returns from a file.  Usage:
  443.  
  444. CLI> RemCr  inputfile  outputfile
  445.  
  446.  
  447. AddCr inserts a carriage-return ahead of every line-feed in a file and
  448. is used to prepare a file for sending to another type of computer.
  449. Usage:
  450.  
  451. CLI> AddCr  inputfile  outputfile
  452.  
  453.  
  454. 13to10 converts all carriage-returns, whose ASCII code is 13 decimal,
  455. to line-feeds, whose ASCII code is 10 decimal.  Usage:
  456.  
  457. CLI> 13to10  inputfile  outputfile
  458.  
  459.  
  460. STRIP removes most control characters, all NULLs, and other "garbage"
  461. from a text file, leaving only line-feeds, and all printable ASCII
  462. characters and symbols.  A file processed by STRIP will be able to be
  463. edited using ED.  Caution: this program also removes TAB characters, so
  464. if tabs are important to you, either use another program, or modify
  465. STRIP's source code to preserve the characters of interest to you.
  466. Usage:
  467.  
  468. CLI> STRIP  inputfile  outputfile
  469.  
  470.  
  471. ----------------------------------------------------------------------
  472.  
  473. PROGRAM TOOLS:  FixObj and FixObj2
  474.  
  475. The FixObj program will fix most problems caused by downloading an
  476. executable program file using XMODEM.  FixObj2 is simply an updated
  477. version of FixObj.
  478.  
  479. FixObj examines an input file for a final "hunkend" and removes
  480. extraneous data beyond that point in the output file. This is the
  481. program to use when you see "Unable to load program: file is not an
  482. object module".  Usage:
  483.  
  484. CLI> FixObj  inputfile  outputfile
  485.  
  486. CAUTION: the inputfile cannot reside on a RAM: disk due to a problem
  487. with the "fseek()" file function in V1.1 AmigaDOS.
  488.  
  489. The source code file and executable program file of FixObj is available
  490. on Fish Disk Number 10.  The source code for FixObj2 is starting to
  491. appear on BBS systems around the country.
  492.  
  493. ----------------------------------------------------------------------
  494.  
  495. PROGRAM TOOLS:  CHOP
  496.  
  497. This program corrects the size of any file whose size must be some
  498. exact quantity.  Very often the "chop size" of a file will be listed on
  499. BBS systems either in the file directory descriptions or in E-MAIL
  500. posted by the person who uploaded the program.  CHOP was the first
  501. available program on the Amiga that corrected XMODEM padding problems.
  502. Variations of CHOP are written in C and in Basic.  All versions expect
  503. an input file name, an output file name, and a chop length.  The "chop
  504. length" is the size you want the output file to be.  For example:
  505.  
  506. CLI> CHOP  inputfile  outputfile  9274
  507.  
  508.  
  509. One version of CHOP written in ABasiC is:
  510.  
  511. 50    input% = 1
  512. 60    output% = 2
  513. 65    count% = 0
  514. 100   input "Input file ";infile$
  515. 110   input "Output file ";outfile$
  516. 115   input "number of bytes to copy";total%
  517. 120   open "i", #input%, infile$
  518. 130   open "o", #output%, outfile$
  519. 200   if eof(input%) then goto 990
  520. 201   if (count% = total%) then goto 990
  521. 210   get #input%, char$
  522. 220   print #output%, using "&"; char$;
  523. 221   count% = count% + 1
  524. 500   goto 200
  525. 990   close #input%
  526. 991   close #output%
  527. 999   end
  528.  
  529. ----------------------------------------------------------------------
  530.  
  531. PROGRAM TOOLS:  ARC
  532.  
  533. ARC, also known as AmigArc, is gaining popularity as the "premier" tool
  534. for file storage on BBS systems and for use on one's own system.  ARC
  535. collects and compresses groups of files together in a single file.  A
  536. multi-file project can have all its files kept together.  And, as with
  537. squeezed files, downloading time is reduced because the files are
  538. compressed.  For example:
  539.  
  540. CLI> list
  541. MEMPROJ.ARC                16640 rwed Yesterday 17:10:57
  542. readme                      2894 rwed Yesterday 17:46:40
  543. mem.sch                    12356 rwed Yesterday 17:46:29
  544. clock.c                     4047 rwed Yesterday 17:46:00
  545. clockset.doc                1205 rwed Yesterday 17:46:07
  546. mechanical                  7107 rwed Yesterday 17:46:13
  547. memtest.c                    468 rwed Yesterday 17:46:31
  548. parts.lst                   1670 rwed Yesterday 17:46:35
  549. clock.sch                   3980 rwed Yesterday 17:46:04
  550. mem.doc                     5284 rwed yesterday 17:46:19
  551. 10 files - 129 blocks used
  552.  
  553. The file named MEMPROJ.ARC is the single file which contains the other
  554. nine files, as shown by:
  555.  
  556. CLI> ARC l MEMPROJ.ARC
  557.  
  558. AmigArc v0.11 TEST version. Please do not use after August 1st,1986.
  559.  
  560. Please refer any comments, BUGS, etc. to:
  561.        Raymond S. Brand
  562.        c/o The Lido Hotel (a Fido BBS)
  563.        (203) 248-7324
  564.        or AMUSE (a Fido BBS)
  565.        (212) 269-4879
  566.  
  567. Name          Length    Date
  568. ============  ========  =========
  569. clock.c           4047  22 Jun 86
  570. clock.sch         3980  22 Jun 86
  571. clockset.doc      1205  22 Jun 86
  572. mechanical        7107  22 Jun 86
  573. mem.doc           5284  22 Jun 86
  574. mem.sch          12356  22 Jun 86
  575. memtest.c          468  22 Jun 86
  576. parts.lst         1670  22 Jun 86
  577. readme            2894  22 Jun 86
  578.         ====  ========
  579. Total      9     39011
  580.  
  581.  
  582. Extensive documentation accompanies ARC.  The three most useful
  583. commands to ARC are L (to list the contents of the archive file), X (to
  584. extract files from the archive file), and A (to add files to the
  585. archive file).  The simplest command forms are:
  586.  
  587. CLI> ARC L archive.file
  588.  
  589. CLI> ARC X archive.file
  590.  
  591. CLI> ARC A archive.file *
  592.  
  593. To avoid overwriting other files when extracting from an archive and to
  594. avoid including other files when building or adding to an archive, it
  595. is easiest to operate ARC while in a unique subdirectory or on a
  596. freshly formatted disk.
  597.  
  598. ARC and its documentation is available from many users' groups and
  599. dealers.  Updated and improved versions of ARC are available
  600. periodically; the current version is V0.11.
  601.  
  602. ----------------------------------------------------------------------
  603.  
  604. PROGRAM TOOLS:  Improved Terminal Programs
  605.  
  606. Last but not least, smarter terminal programs are becoming available
  607. that will ease the burden of deciphering problems with XMODEM file
  608. transfers.  Some programs include the capabilities of FixObj, and
  609. others combine the functions of RemCr, AddCr, 13to10 and STRIP while
  610. doing a file transfer.
  611.  
  612. It is to your benefit to throroughly read the documentation that
  613. accompanies your terminal program, and request new features in updated
  614. versions.  Many software producers do listen to their customer's
  615. suggestions with the result that everyone "wins" as products evolve to
  616. solve your requirements.
  617.  
  618.  
  619. end
  620.